﻿========================================================================
  UniversalMigrator - 汎用コード移行ツール  Version 0.2.0
========================================================================

  ソフト名     : UniversalMigrator - 汎用コード移行ツール
  バージョン   : 0.2.0
  作 者        : highdefinitionaudiodriver
  動作環境     : Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ライセンス   : MIT License（フリーソフト／オープンソース）
  種 別        : フリーソフト
  作成日       : 2026-06-08

------------------------------------------------------------------------
■ ソフトの説明 / 使用方法（README より）
------------------------------------------------------------------------

UniversalMigrator

レガシーコード移行の初期診断と変換たたき台を作る GUI / CLI ツール

66 種類のプログラミング言語に対応し、Anthropic Claude API を AI エンジンとして使用します。
フォルダ内のファイルを一括解析・変換し、サブフォルダ構造も維持します。

> 目的は「完全自動で本番移行を終えること」ではなく、既存コード資産を読み取り、移行方針・難易度・変換候補を早く見える形にすることです。

---

🎯 これは何？（30秒で）

- 誰のため：複数言語のレガシー資産を抱える情シス・SI ベンダー／言語移行の PoC を企画している開発リード
- 何が解決される：66 言語に対応した 「移行たたき台＋難易度可視化」 ツール。Oracle2PostgreSQL や cobol2java のような言語固定ツールでは扱えない「あらゆる組み合わせ」をカバー
- なぜ既存ツールではダメか：商用変換ツールは言語固定が多く、ニッチな組合せ（VB6→Python、SAS→R 等）に対応しない。本ツールは Claude API を AI エンジンとして柔軟に対応
- 使う条件：Python 3.10+ / Anthropic API キー／GUI または CLI

💰 想定ユースケース・価格帯

| 用途 | 形態 |
|---|---|
| OSS としての利用（自社 PoC・社内見積もり） | 無料（MIT。Claude API 料金は別途） |
| 言語移行プロジェクトのアセスメント受託 | 応相談 |
| 業務特化の追加プロンプト・ガードレール開発 | 個別見積もり |

---

活用シーン

- COBOL / VBA / PL/SQL / レガシー言語の移行前PoC
- 移行先言語での実装イメージ、変換率、手修正ポイントの初期把握
- プロジェクト見積もり前のサンプル診断
- CI/CD やバッチ処理に組み込んだ段階的なコード変換検証

---

主な機能

| 機能 | 説明 |
|---|---|
| 66 言語対応 | Python, Java, C/C++, C#, Go, Rust, TypeScript, COBOL, VBA, Swift, Kotlin 他 |
| 指数バックオフリトライ | 429 / Timeout / 529 エラー時に自動リトライ（最大 5 回） |
| レジューム | SHA-256 ハッシュで変換済みファイルを管理、中断後も途中から再開 |
| 出力サニタイズ | AI が付加するマークダウンフェンスや自然言語の解説を自動除去 |
| コンテキスト注入 | 定数 / 設定ファイルを先に変換し、後続ファイルの変換精度を向上 |
| エコシステム変換 | requirements.txt → package.json 等、プロジェクトファイルも自動変換 |
| GUI（8 言語 UI） | 日本語 / English / 中文 / 한국어 / Espanol / Francais / Deutsch / Portugues |
| CLI | CI/CD やバッチ処理に対応 |

必要なもの

- Anthropic API キー（[console.anthropic.com](https://console.anthropic.com/) で取得）
- EXE 版: 不要（Python 不要）
- ソース版: Python 3.9+

インストール

EXE 版（推奨）

1. [Releases](../../releases) から UniversalMigrator.exe をダウンロード
2. 任意のフォルダに配置
3. ダブルクリックで起動

ソース版


git clone https://github.com/highdefinitionaudiodriver/UniversalMigrator.git
cd UniversalMigrator
pip install -r requirements.txt
python main.py


使い方

GUI モード


python main.py


1. 変換元言語と変換先言語を選択
2. 入力 / 出力フォルダを指定
3. API キーを入力（環境変数 ANTHROPIC_API_KEY 設定済みなら不要）
4. 「変換開始」をクリック

CLI モード


Python → Rust
python main.py -i ./python_src -o ./rust_out -s Python -t Rust

COBOL → Java
python main.py -i ./cobol_src -o ./java_out -s COBOL -t Java

VBA → Python（Shift_JIS）
python main.py -i ./vba_src -o ./py_out -s VBA -t Python -e cp932

対応言語一覧
python main.py --list-languages


CLI オプション

| オプション | 説明 |
|---|---|
| -i, --input | 入力フォルダ（必須） |
| -o, --output | 出力フォルダ（必須） |
| -s, --source | 変換元言語（必須） |
| -t, --target | 変換先言語（必須） |
| -k, --api-key | API キー |
| -m, --model | モデル（default: claude-sonnet-4-20250514） |
| -e, --encoding | ソースエンコーディング（default: utf-8） |
| --extra | 追加指示 |
| --no-resume | レジューム無効化 |
| --no-context | コンテキスト注入無効化 |
| --no-ecosystem | エコシステム変換無効化 |
| --list-languages | 対応言語一覧を表示 |

対応言語（66 言語）

ABAP, Ada, AppleScript, Assembly (x86), AutoHotkey, Bash/Shell, Batch, C, C#, C++, Clojure, COBOL, CoffeeScript, Crystal, CSS, D, Dart, Delphi/Pascal, Elixir, Elm, Erlang, F#, Fortran, Go, Groovy, Hack, Haskell, HTML, Java, JavaScript, Julia, Kotlin, LabVIEW, Lisp, Lua, MATLAB, Nim, Objective-C, OCaml, Perl, PHP, PL/SQL, PowerShell, Prolog, Python, R, Racket, Ruby, Rust, SAS, Scala, Scheme, Scratch, SCSS/Sass, Smalltalk, Solidity, SQL, Swift, T-SQL, Tcl, TypeScript, VB.NET, VBA, Verilog, VHDL, Zig

アーキテクチャ


main.py                    エントリポイント（GUI/CLI）
src/
  languages.py             66 言語定義
  migrator.py              変換エンジン（Claude API + リトライ + レジューム）
  sanitizer.py             出力サニタイズ
  resume_state.py          レジューム状態管理（SHA-256）
  ecosystem.py             エコシステムファイルマッピング + 優先度ソート
  gui_model.py             MVC Model
  gui_view.py              MVC View（tkinter）
  gui_controller.py        MVC Controller
  i18n.py                  多言語対応（8 言語）


EXE ビルド


Windows
build.bat

macOS / Linux
./build.sh


ライセンス

MIT License - Copyright (c) 2026 highdefinitionaudiodriver

---

🤝 商用利用・カスタマイズ依頼

- 個人・社内利用は無料（MIT ライセンス）
- 法人・自治体・SI 向け導入支援、カスタマイズ、診断レポート受託は応相談
- 連絡先：highdefinitionaudiodriver@gmail.com

<!-- CODEX-CURRENT-STATUS:START -->
現状サマリ (2026-05-25)

- 対象: UniversalMigrator
- 作業ブランチ: main
- README更新時点の参照コミット: a428bd9 docs: docs/RELATED_TOOLS.md - 移行ツール群の関係図と使い分け
- Python 実行環境向けに requirements.txt を同梱。
- docs ディレクトリ配下に設計・運用・補足資料を配置。
- src ディレクトリ配下に主要実装を配置。
- 主要な確認コマンド: python -m pytest または README 記載の Python コマンド
- 次に進めるなら、README 内の利用手順と既存 docs / tests を起点に、未整備の検証手順・引き継ぎメモ・CI 化を補強する。
<!-- CODEX-CURRENT-STATUS:END -->

------------------------------------------------------------------------
■ 動作環境
------------------------------------------------------------------------
  Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ※ オンライン専用ソフトではありません（ローカル環境で動作します）。

------------------------------------------------------------------------
■ インストール / アンインストール
------------------------------------------------------------------------
  ・本アーカイブを任意のフォルダに展開してください。
  ・詳細な起動手順は上記「ソフトの説明」および同梱の README を参照してください。
  ・アンインストールは展開したフォルダを削除するだけです（レジストリ不使用）。

------------------------------------------------------------------------
■ 転載・再配布について
------------------------------------------------------------------------
  本ソフトは MIT License のオープンソースです。同梱の LICENSE 条文に
  従う限り、自由に利用・改変・再配布できます。
  なお Vector 以外の配布サイトへの無断転載はご遠慮ください。

------------------------------------------------------------------------
■ 免責事項
------------------------------------------------------------------------
  本ソフトの使用によって生じたいかなる損害についても、作者は一切の
  責任を負いません。利用者ご自身の責任においてご使用ください。

------------------------------------------------------------------------
■ 著作権
------------------------------------------------------------------------
  Copyright (c) 2026 highdefinitionaudiodriver
  本ソフトは MIT License の下で公開されています。

------------------------------------------------------------------------
■ 連絡先 / サポート
------------------------------------------------------------------------
  作 者        : highdefinitionaudiodriver
  E-mail       : highdefinitionaudiodriver@gmail.com
  GitHub       : https://github.com/highdefinitionaudiodriver/UniversalMigrator.git
  不具合報告・ご要望は上記 E-mail もしくはリポジトリの Issues へ
  お願いいたします。

========================================================================
